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Abstract 
To reduce the likelihood of conflict and confusion when relating 


documented examples to deployed systems, an IPv6 unicast address 
prefix is reserved for use in examples in RFCs, books, documentation, 


and the like. Since site-local and link-local unicast addresses have 
special meaning in IPv6, these addresses cannot be used in many 
example situations. The document describes the use of the IPv6 
address prefix 2001:DB8::/32 as a reserved prefix for use in 
documentation. 

1. Introduction 


The address architecture for IPv6é [1] does not specifically allocate 
an IPv6 address prefix for use for documentation purposes. 
Documentation material is currently using address prefixes drawn from 
address blocks already allocated or assigned to existing 
organizations or to well known ISPs, or drawn from the currently 
unallocated address pool. Such use conflicts with existing or future 
allocations or assignments of IPv6 address space. 


The problems such conflicts may cause have already been encountered 
with IPv4 where literal use of documented examples in a production 
environment causes address and routing conflicts with existing 
services. In making an explicit allocation of a documentation 
address prefix, it is intended that such operational problems may be 
avoided for IPv6. 
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Similar, but different, discussion also applies to top level domain 
names and some have been reserved for similar purposes [2]. 


2. Documentation IPv6 Address Prefix 


To allow documentation to accurately describe deployment examples, 
the use of site local or link local addresses is inappropriate, anda 
unicast address block is required. All IPv6 unicast address space is 
currently marked as reserved, unassigned or has been assigned to the 
Internet Assigned Numbers Authority (IANA) for further redistribution 
to the Regional Internet Registries (RIRs) [1], but no unicast 
address space has been specifically nominated for the purposes of use 
in documented examples. 


Following acceptance within the Asia Pacific regional addressing 
community of a proposal for a block of IPv6 address space to be 
reserved for documentation purposes, the Asia Pacific Network 
Information Centre (APNIC) allocated a unicast address prefix for 
documentation purposes. The address block is within the range of a 
conventional allocation size, so that documentation can accurately 
match deployment scenarios. 


The documentation prefix described in this memo can also be used to 
generate multicast addresses for documentation, using the Unicast 
prefix-based proposal [3]. Representing other kinds of multicast 
addresses in documentation is outside the scope of this memo. 


The prefix allocated for documentation purposes is 2001:DB8::/32 

3. Operational Implications 
This assignment implies that IPv6 network operators should add this 
address prefix to the list of non-routeable IPv6 address space, and 
if packet filters are deployed, then this address prefix should be 
added to packet filters. 


This is not a local-use address prefix, and the filters may be used 
in both local and public contexts. 


4. IANA Considerations 
IANA is to record the allocation of the IPv6 global unicast address 


prefix 2001:DB8::/32 as a documentation-only prefix in the IPv6 
address registry. No end party is to be assigned this address. 
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Security Considerations 
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IPv6 addressing documents do not have any direct impact on Internet 


infrastructure security. 
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Full Copyright Statement 
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to the rights, licenses and restrictions contained in BCP 78, and 
except as set forth therein, the authors retain all their rights. 


This document and the information contained herein are provided on an 
"AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS 
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assurances of licenses to be made available, or the result of an 
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this standard. Please address the information to the IETF at ietf- 
ipr@ietf.org. 


Acknowledgement 


Funding for the RFC Editor function is currently provided by the 
Internet Society. 


Huston, et al. Informational [Page 4] 


